/*
 * @Author: 0x9DEFA478
 * @Date: 2024-07-31 16:38:37
 * @LastEditTime: 2024-07-31 17:12:11
 * @LastEditors: 0x9DEFA478
 * @Description: 
 * QQ:2652450237
 * ============================================================================================================================================
 * 
 * 
 * 
 *                                                                                               ************      ****************************
 *                                                                                             ************      ****************************  
 *                                                                                           ************      ****************************    
 *                                                                                         ************      ****************************      
 *                                                                                       ************      ************                        
 *                                                                                     ************      ************                          
 *                                                                                   ************      ************                            
 *                                                                                 ************      ************                              
 *                                                                               ************      ************                                
 *                                                                             ************      ************                                  
 *                                                                           ************      ************                                    
 *                                                                         ************      ************                                      
 *                                                                       ************      ************                                        
 *                                                                     ************      ************                                          
 *                                                                   ************      ************                                            
 *                                                                 ************      ************                                              
 *                                                               ************      ************                                                
 *                                                             ************      ************                                                  
 *                                                           ************      ************                                                    
 *                                                         ************      ************                                                      
 *                                                       ************      ************                                                        
 *                                                     ************      ************                                                          
 *                                                   ************      ************                                                            
 *                                                 ************      ************                                                              
 *                                               ************      ************                                                                
 *                                             ************      ************                                                                  
 *                                           ************      ************                                                                    
 *                                         ************      ************                                                                      
 *                                       ************      ************                                                                        
 *                                     ************      ************                                                                          
 *                                   ************      ************                                                                            
 *                                 ************      ************                                                                              
 *                               ************      ************                                                                                
 *                             ************      ************                                                                                  
 *                           ************      ************                                                                                    
 *                         ************      ************                                                                                      
 *       ****************************      ************                                                                                        
 *     ****************************      ************                                                                                          
 *   ****************************      ************                                                                                            
 * ****************************      ************                                                                                              
 * 
 * 
 * 
 * ============================================================================================================================================
 * 
 */
#ifndef hAPI_H_TS_Event_H_
#define hAPI_H_TS_Event_H_
#include "./H_TS_Thread.h"




typedef struct{
  H_TS_Thread* volatile Owner;
  volatile Hsize Active;
}H_TS_Event;




/**
 * @brief 将一块内存构造为事件
 * @param Event 待构造的内存
 * @return 无
 */
void H_TS_Event_Init(H_TS_Event* Event);

/**
 * @brief 将一个事件析构为普通内存
 * @param Lock 要析构的事件句柄
 * @return 0:成功 -1:事件正在被其他线程占用
 */
int H_TS_Event_Deinit(H_TS_Event* Event);

/**
 * @brief 新建一个事件句柄
 * @return 事件句柄 如果为NULL 则表示失败
 */
H_TS_Event* new_H_TS_Event(void);

/**
 * @brief 删除事件句柄
 * @param Event 要删除的事件句柄
 * @return 0:成功 -1:有线程因此信号阻塞
 */
int delete_H_TS_Event(H_TS_Event* Event);

/**
 * @brief 触发事件 由中断调用
 * @param Event 要触发的事件句柄
 * @return 0:成功 -1:事件已触发
 */
int H_TS_Event_Triggering_ISR(H_TS_Event* Event);

/**
 * @brief 触发事件
 * @param Event 要触发的事件句柄
 * @return 0:成功 -1:事件已触发
 */
int H_TS_Event_Triggering(H_TS_Event* Event);

/**
 * @brief 尝试接受事件 如果接受到事件后事件被清除
 * @param Event 要等待的事件句柄
 * @return 0:成功 其他:无事件
 */
int H_TS_Event_TryTake(H_TS_Event* Event);

/**
 * @brief 接受事件 接受到事件后事件被清除
 * @param Event 要等待的事件句柄
 * @return 如果无信号 将一直阻塞 直到有信号
 */
void H_TS_Event_Take(H_TS_Event* Event);

/**
 * @brief 接受事件 接受到事件后事件被清除 时间限制
 * @param Event 要等待的事件句柄
 * @param Timeout 最大等待时间
 * @return 0:成功 其他:等待超时
 */
int H_TS_Event_Take_Time(H_TS_Event* Event,H_TS_Tick Timeout);




#endif //hAPI_H_TS_Event_H_
